home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / atmem10.zip / ATMEM.DOC < prev    next >
Text File  |  1992-08-01  |  5KB  |  143 lines
  1. ATMEM v1.0, 1 august 1992
  2. =========================
  3. by Charles Vachon
  4.  
  5.  
  6. BAD NEWS : THIS SOFTWARE IS NOT PUBLIC DOMAIN!
  7. GOOD NEWS: THIS SOFTWARE IS FREEWARE!
  8.  
  9. YOU CAN:
  10.  
  11.   - USE THIS SOFTWARE WITHOUT RESTRICTION FOR NON-PROFIT PURPOSES
  12.   - DISTRIBUTE THIS SOFTWARE, PROVIDED THAT IT IS BEING DISTRIBUTED IN
  13.     IT'S ORIGINAL, COMPLETE FORMAT, COMPRISED OF:
  14.     - ATMEM.EXE, THE EXECUTABLE ITSELF
  15.     - ATMEM.DAT, A SAMPLE DATA FILE
  16.     - ATMEM.DOC, THIS DOCUMENTATION
  17.     - C000.EXE, A COMPLIMENTARY EXECUTABLE
  18.  
  19. YOU CAN NOT:
  20.  
  21.   - HOLD THE AUTHOR OF THIS SOFTWARE RESPONSIBLE FOR ANY LOSS RELATED TO
  22.     THE DIRECT OR INDIRECT USE OF THIS SOFTWARE
  23.  
  24.   - MODIFY THE PROGRAM OR IT'S DOCUMENTATION
  25.  
  26. ATMEM Raison d'être:
  27.  
  28. As a network administrator, I am facing the ever increasing variety of
  29. hardware installed in the workstations. My goal is to provide users with a
  30. consistent menu interface, regardless of the hardware they use. Here, we
  31. have various utilities to report on the CPU type, screen type, memory
  32. available, etc... of the PCs on which they are run. We had one need that has
  33. not been satisfied as yet, however. Specifically, we need to know what
  34. **kind** of video adapter is installed in a PC, in order to call the right
  35. video driver in our network batch files. I never found such an utility, so I
  36. wrote it! Here is ATMEM!
  37.  
  38. How it works?
  39.  
  40. In order to know what to look for and what to report, ATMEM uses a text file
  41. that contains all instructions. The file can be named as you like, since the
  42. name is passed as the FIRST PARAMETER on the command-line. Provided in this
  43. package is an example file named ATMEM.DAT, reproduced here:
  44.  
  45. ATMEM VERSION 1.0 DATA FILE
  46. VBOARD=UNKNOWN
  47. $C000 $0035 VBOARD=PAR256  003056-007COPYRIGHT PARADISE
  48. $C000 $002D VBOARD=PAR1024 PARADISE003145-110
  49. <EOF>
  50.  
  51. Here's the meaning of these lines:
  52.  
  53. The first one, ATMEM VERSION 1.0 DATA FILE, allows the executable to
  54. recognize that this file is really an ATMEM data file. The presence of
  55. this line is mandatory.
  56.  
  57. The second line, VBOARD=UNKNOWN, tells ATMEM what it should report in the
  58. case that no data lines (to be explained below) matched the PC's memory.
  59. This line will be written as a SET command in a batch file, whose
  60. complete name is specified as the SECOND PARAMETER on the command line
  61. (optional).
  62.  
  63. Next come the data lines. There has to be at least one if you want ATMEM to
  64. do something useful, and there can be as many as you like. The format of a
  65. data line is:
  66.  
  67.   The first string (blank delimited) represents the segment of memory to
  68.   search. It has to be a positive integer either in decimal or hex
  69.   notation. In the latter case, a $ sign must precede the number. Valid
  70.   examples are: 49152 $C000.
  71.  
  72.   The second string is the offset of memory to search. The same syntax rules
  73.   apply as for the segment address.
  74.  
  75.   The third string (blank delimited, so no embedded blanks are allowed in
  76.   this string) contains the string to write as the SET command in the batch
  77.   file if the id string (to be explained) matches memory at the address
  78.   given by segment:offset. Please note that the part of the string is case-
  79.   sensitive (being a SET value).
  80.  
  81.   The rest of the line, from the fourth string up, is the id string. It is
  82.   the data that ATMEM will try to match against memory. Please notice that
  83.   this string is case-sensitive, and that embedded blanks are significant to
  84.   ATMEM, that is they will be used in comparisons as any regular characters.
  85.  
  86. Then comes the end of the file. Don't place the <EOF> in your file, it's
  87. just a representation of the end of file, not text that has a special
  88. meaning.
  89.  
  90. For example:
  91.  
  92. In the example file above, the batch file created by ATMEM would look like
  93. SET VBOARD=PAR1024
  94. if the PC's memory at $C000:$002D contained the string PARADISE003145-110
  95. and it would look like
  96. SET VBOARD=UNKNOWN
  97. if none of the data lines matched the PC's memory.
  98.  
  99. Notes:
  100.  
  101. - The command-line syntax for ATMEM is:
  102.  
  103.   ATMEM data_file batch_filespec
  104.  
  105.   If no parameter is passed, ATMEM will display a help screen.
  106.  
  107.   If no batch file spec is passed to ATMEM, it will simply write to
  108.   the standard output (redirectable).
  109.  
  110. - ATMEM reports on it's abormal termination with self-explanatory error
  111.   messages, and an errorlevel of 1 (0 on normal completion).
  112.  
  113. - The data lines are all read into memory before the lines are compared
  114.   against memory.
  115.  
  116. - The lines are processed sequentially, and processing stops at the
  117.   first data line that matches the memory contents.
  118.  
  119. - WHAT A CHEAPO WAY TO WRITE TO ENVIRONMENT some will say! Yes, it's less
  120.   elegant than writing directly in the environment. As a defense I will say
  121.   "This one works regardless of the DOS version you use (even **future**
  122.   versions)" and "It's much faster for me to code it like this".
  123.  
  124. - What about C000.EXE? It's just a small utility i wrote that dumps the
  125.   first 256 characters at address hex C000:0000 in a file named C000.DAT. I
  126.   helped us sorting the various VGA BIOSes in our machines.
  127.  
  128. - This program was created to help identify VGA video boards but as you
  129.   should no, you can test ANY memory location against a list of choices, so
  130.   it may be useful for other purposes than originally designed for.
  131.  
  132. Comments:
  133.  
  134. Please send comments/suggestions to:
  135.  
  136. Charles Vachon
  137. 170 De Bray
  138. Bernières, Quebec, Canada
  139. G7A 1T3
  140.  
  141. internet: CVACHON@VM1.ULAVAL.CA
  142.  
  143.